home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / il_c / ilFMultImg.z / ilFMultImg
Encoding:
Text File  |  2002-10-03  |  9.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4. iiiillllFFFFMMMMuuuullllttttIIIImmmmgggg((((3333))))      IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll      iiiillllFFFFMMMMuuuullllttttIIIImmmmgggg((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      iiiillllFFFFMMMMuuuullllttttIIIImmmmgggg - Multiplies two complex fourier domain images
  10.  
  11. IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM
  12.      ilLink : ilImage : ilCacheImg : ilMemCacheImg : ilOpImg : ilFDyadicImg
  13.  
  14. HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
  15.      #include <il/ilCdefs.h>
  16.  
  17. CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      iiiillllFFFFMMMMuuuullllttttIIIImmmmgggg(((()))) performs pointwise complex multiplication between two
  19.      fourier domain images. It is publicly derived from ilFDyadicImg and is
  20.      one of the Fourier operators. Its two source images should have the same
  21.      format as that produced by a forward 2D-FFT.  It can be one of a chain of
  22.      operators that follows a forward 2D-FFT and precedes an inverse 2D-FFT.
  23.  
  24.      The result of mutiplying two fourier domain images is equivalent to a
  25.      convolution in the spatial domain, which is a digital filter that can be
  26.      designed to achieve a variety of purposes.  Convolution of an image by
  27.      large kernels in the spatial domain quickly becomes inefficient as the
  28.      kernel size increases.  Such large kernels can perform various operations
  29.      from simple filtering to image restoration.  Since the Fourier transform
  30.      uses an efficient FFT algorithm, the Fourier domain multiplication can be
  31.      much more efficient than the spatial domain convolution if the kernel
  32.      size is large (for example, 63*63).
  33.  
  34. CCCCLLLLAAAASSSSSSSS MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN SSSSUUUUMMMMMMMMAAAARRRRYYYY
  35.      CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrr
  36.  
  37.           ilFMultImg *ilFMultImgCreate(ilImage *src1, ilImage *src2)
  38.  
  39.  
  40. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
  41.      iiiillllFFFFMMMMuuuullllttttIIIImmmmgggg(((())))
  42.  
  43.           ilFMultImg *ilFMultImgCreate(ilImage *src1, ilImage *src2)
  44.  
  45.  
  46.           Constructor for this class. _s_r_c_1 and _s_r_c_2 are the two source images
  47.           whose product is to be computed.  _s_r_c_1 and _s_r_c_2 should have the same
  48.           format as that produced by a forward 2D-FFT.  _s_r_c_1 and _s_r_c_2 should
  49.           be of the same size.
  50.  
  51. IIIINNNNHHHHEEEERRRRIIIITTTTEEEEDDDD MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNNSSSS
  52.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm iiiillllOOOOppppIIIImmmmgggg
  53.      ilOpImgClearClamp(), ilOpImgGetBias(), ilOpImgGetClamp(),
  54.      ilOpImgGetValidOrders(), ilOpImgGetValidTypes(), ilOpImgIsClamped(),
  55.      ilOpImgIsPrecisionKept(), ilOpImgKeepPrecision(), ilOpImgSetBias(),
  56.      ilOpImgSetClampMinMax(), ilOpImgSetClamp()
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiillllFFFFMMMMuuuullllttttIIIImmmmgggg((((3333))))      IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll      iiiillllFFFFMMMMuuuullllttttIIIImmmmgggg((((3333))))
  71.  
  72.  
  73.  
  74.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm iiiillllMMMMeeeemmmmCCCCaaaacccchhhheeeeIIIImmmmgggg
  75.      ilMemCacheImgEnableMP(), ilMemCacheImgGetPageTime(),
  76.      ilMemCacheImgGetRetainMode(), ilMemCacheImgGetThrashMode(),
  77.      ilMemCacheImgGetThrashTime(), ilMemCacheImgGetTotalPageTime(),
  78.      ilMemCacheImgIsMPenabled(), ilMemCacheImgSetRetainMode(),
  79.      ilMemCacheImgSetThrashMode()
  80.  
  81.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm iiiillllCCCCaaaacccchhhheeeeIIIImmmmgggg
  82.      ilCacheImgFlush(), ilCacheImgGetCacheSize()
  83.  
  84.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm iiiillllIIIImmmmaaaaggggeeee
  85.      ilAddInput(), ilAllocFillData(), ilClipTile(), ilClipTileAsTile(),
  86.      ilClipTileFloat(), ilClipTileFloatAsTile(),
  87.      ilConfigureRetainedCacheImage(), ilCopy(), ilCopyTile(), ilCopyTile3D(),
  88.      ilCopyTileCfg(), ilFillTile(), ilFillTile3D(), ilFillTileRGB(),
  89.      ilFreeFillData(), ilGetColorImg(), ilGetColorModel(), ilGetColormap(),
  90.      ilGetColormapPtr(), ilGetCompression(), ilGetConfig(), ilGetCsize(),
  91.      ilGetDataType(), ilGetDimensions(), ilGetDirectInput(),
  92.      ilGetDisplayCacheEnable(), ilGetFill(), ilGetFillData(),
  93.      ilGetFillValue(), ilGetHeight(), ilGetHwEnable(), ilGetHwHint(),
  94.      ilGetHwHintName(), ilGetHwIntHint(), ilGetHwIntHintName(), ilGetInput(),
  95.      ilGetInputTileRequirement(), ilGetLockTileSet(), ilGetMappedPageSize(),
  96.      ilGetMappedSize(), ilGetMaxColormapLevels(), ilGetMaxValue(),
  97.      ilGetMinValue(), ilGetNumChans(), ilGetNumInputs(), ilGetOrder(),
  98.      ilGetOrientation(), ilGetPageBorder(), ilGetPageBorderPtr(),
  99.      ilGetPageBorderX(), ilGetPageBorderY(), ilGetPageBorderZ(),
  100.      ilGetPageCounts(), ilGetPageDelta(), ilGetPageDeltaStruct(),
  101.      ilGetPageDimensions(), ilGetPageIndices(), ilGetPageOrigin(),
  102.      ilGetPageOriginC(), ilGetPageOriginStruct(), ilGetPageOriginX(),
  103.      ilGetPageOriginY(), ilGetPageOriginZ(), ilGetPageSize(),
  104.      ilGetPageSizeBytes(), ilGetPageSizeC(), ilGetPageSizePix(),
  105.      ilGetPageSizeStruct(), ilGetPageSizeVal(), ilGetPageSizeX(),
  106.      ilGetPageSizeXY(), ilGetPageSizeY(), ilGetPageSizeZ(), ilGetPixel(),
  107.      ilGetPixel3D(), ilGetPriority(), ilGetScaleMax(), ilGetScaleMin(),
  108.      ilGetSize(), ilGetSizePtr(), ilGetStrides(), ilGetSubTile(),
  109.      ilGetSubTile3D(), ilGetTile(), ilGetTile3D(), ilGetWidth(), ilGetXsize(),
  110.      ilGetYsize(), ilGetZsize(), ilHasPageBorder(), ilHasPages(),
  111.      ilInitScaleMinMax(), ilIsColorImg(), ilIsIntegral(),
  112.      ilIsMirrorOrientation(), ilIsSigned(), ilIsWritable(), ilLockPage(),
  113.      ilLockPageSet(), ilLockTile(), ilLockTile3D(), ilMapFlipTrans(),
  114.      ilMapFromInput(), ilMapFromInput2D(), ilMapFromInput3D(),
  115.      ilMapFromSource(), ilMapFromSource2D(), ilMapFromSource3D(),
  116.      ilMapOrientation(), ilMapSize(), ilMapTile(), ilMapTileFlipTrans(),
  117.      ilMapTileFloat(), ilMapToInput(), ilMapToInput2D(), ilMapToInput3D(),
  118.      ilMapToSource(), ilMapToSource2D(), ilMapToSource3D(), ilMapXY(),
  119.      ilMapXYFloat(), ilMapXYSign(), ilQCopyTileCfg(), ilQFillTile3D(),
  120.      ilQFillTileRGB(), ilQGetSubTile3D(), ilQGetTile3D(), ilQLockPageSet(),
  121.      ilQSetSubTile3D(), ilQSetTile3D(), ilRemoveHwHint(),
  122.      ilRemoveHwHintName(), ilRemoveInput(), ilSetColorModel(),
  123.      ilSetColormap(), ilSetCompression(), ilSetCsize(), ilSetDataType(),
  124.      ilSetDisplayCacheEnable(), ilSetFill(), ilSetFillValue(),
  125.      ilSetHwEnable(), ilSetHwHint(), ilSetHwIntHint(), ilSetHwIntHintName(),
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. iiiillllFFFFMMMMuuuullllttttIIIImmmmgggg((((3333))))      IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll      iiiillllFFFFMMMMuuuullllttttIIIImmmmgggg((((3333))))
  137.  
  138.  
  139.  
  140.      ilSetInput(), ilSetMaxColormapLevels(), ilSetMaxValue(), ilSetMinValue(),
  141.      ilSetNumChans(), ilSetOrder(), ilSetOrientation(), ilSetPageBorder(),
  142.      ilSetPageBorderStruct(), ilSetPageSize(), ilSetPageSizeC(),
  143.      ilSetPageSizeStruct(), ilSetPageSizeXY(), ilSetPageSizeZ(), ilSetPixel(),
  144.      ilSetPixel3D(), ilSetPriority(), ilSetScaleMinMax(), ilSetScaleType(),
  145.      ilSetSize(), ilSetSubTile(), ilSetSubTile3D(), ilSetTile(),
  146.      ilSetTile3D(), ilSetXYsize(), ilSetXsize(), ilSetYsize(), ilSetZsize(),
  147.      ilUnlockPage(), ilUnlockPageSet()
  148.  
  149.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm iiiillllLLLLiiiinnnnkkkk
  150.      ilLinkClearSet(), ilLinkClearStatus(), ilLinkGetDescription(),
  151.      ilLinkGetDirectParent(), ilLinkGetDisabledIndex(), ilLinkGetFloatProp(),
  152.      ilLinkGetGenerationID(), ilLinkGetIntProp(), ilLinkGetNumChildren(),
  153.      ilLinkGetNumParents(), ilLinkGetParent(), ilLinkGetPtrProp(),
  154.      ilLinkGetRelatedChild(), ilLinkGetRelatedDelete(),
  155.      ilLinkGetRelatedType(), ilLinkGetStatus(), ilLinkIsAllowed(),
  156.      ilLinkIsAltered(), ilLinkIsEnabled(), ilLinkIsRelated(), ilLinkIsSet(),
  157.      ilLinkRemoveParent(), ilLinkRemoveProp(), ilLinkSetDescription(),
  158.      ilLinkSetDisabledIndex(), ilLinkSetEnabled(), ilLinkSetParent(),
  159.      ilLinkSetProp(), ilLinkSetRelatedDelete(), ilLinkSetRelatedType()
  160.  
  161. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  162.      ilRFFTfImg, ilRFFTiImg, ilOpImg, ilFDyadicImg
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.